SBT (Scala Build Tool) 教程
1. 简介
SBT (Simple Build Tool) 是 Scala 项目的主要构建工具。它不仅支持 Scala，还支持 Java 和其他 JVM 语言。SBT 提供了强大的依赖管理、任务执行和插件系统，使得构建和测试 Scala 项目变得简单高效。
2. 安装 SBT
2.1 下载与安装
首先，你需要从 SBT 官方网站 下载 SBT 的安装包。根据你的操作系统选择合适的版本进行下载。
2.2 配置环境变量
安装完成后，确保将 SBT 的 bin 目录添加到系统的 PATH 环境变量中。这样你就可以在命令行中直接使用 sbt 命令。
2.3 验证安装
打开命令行工具，输入以下命令来验证 SBT 是否安装成功：
sbt sbtVersion
如果安装成功，你应该会看到当前 SBT 的版本号。
3. 创建第一个 SBT 项目
3.1 初始化项目
在命令行中，导航到你想要创建项目的目录，然后运行以下命令来初始化一个新的 SBT 项目：
sbt new scala/scala-seed.g8
这个命令会创建一个基本的 Scala 项目结构。
3.2 项目结构
初始化完成后，你的项目目录结构应该如下所示：
my-first-sbt-project/
├── build.sbt
├── project/
│ └── build.properties
└── src/
├── main/
│ └── scala/
│ └── Main.scala
└── test/
└── scala/
└── MainSpec.scala
build.sbt: 项目的构建配置文件。project/: 包含项目元数据的目录。src/main/scala/: 存放 Scala 源代码的目录。src/test/scala/: 存放测试代码的目录。
3.3 运行项目
进入项目目录，运行以下命令来编译和运行项目：
sbt run
你应该会看到输出 "Hello, World!"，这是默认的 Scala 项目输出。
4. build.sbt 文件详解
build.sbt 是 SBT 项目的核心配置文件。它定义了项目的名称、版本、依赖等信息。
4.1 基本结构
一个简单的 build.sbt 文件可能如下所示：
name := "my-first-sbt-project"
version := "0.1"
scalaVersion := "2.13.6"
libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.9" % Test
name: 项目的名称。version: 项目的版本号。scalaVersion: 项目使用的 Scala 版本。libraryDependencies: 项目的依赖库。
4.2 添加依赖
你可以通过 libraryDependencies 来添加项目所需的依赖库。例如，添加一个测试库：
libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.9" % Test
这里的 %% 表示 SBT 会自动根据当前的 Scala 版本选择合适的库版本。
5. SBT 任务
SBT 提供了许多内置任务，帮助你管理项目。
5.1 常用任务
compile: 编译项目。run: 运行项目。test: 运行测试。clean: 清理编译输出。
5.2 自定义任务
你也可以在 build.sbt 中定义自定义任务。例如，定义一个任务来打印项目名称：
lazy val printProjectName = taskKey[Unit]("Prints the project name")
printProjectName := {
println(name.value)
}
然后在命令行中运行：
sbt printProjectName
你应该会看到项目名称被打印出来。
6. 实践练习
6.1 练习1：添加依赖
在你的项目中添加一个新的依赖库，例如 cats，并编写一个简单的代码示例来使用该库。
6.2 练习2：自定义任务
定义一个自定义任务，该任务会打印出当前项目的 Scala 版本。
6.3 练习3：构建和运行
使用 SBT 构建并运行你的项目，确保所有依赖都正确加载，并且项目能够正常运行。
7. 总结
通过本教程，你已经学会了如何安装和配置 SBT，创建和管理 Scala 项目，以及如何使用 SBT 任务来构建和测试项目。SBT 是一个功能强大的工具，掌握它将极大地提高你在 Scala 开发中的效率。
希望你能继续深入学习 SBT 的高级功能，如插件系统、多模块项目管理等，进一步提升你的 Scala 开发技能。